package com.tencent.wxcloudrun.service;

import java.util.List;

import com.baomidou.mybatisplus.extension.service.IService;
import com.tencent.wxcloudrun.domain.TUserCardApply;
import com.tencent.wxcloudrun.domain.TUserCardRecord;
import com.tencent.wxcloudrun.dto.UserCardExportRecordResDTO;

/**
 * @author ziyin.zhao
 * @description 针对表【t_user_card_record(用户卡片记录表)】的数据库操作Service
 * @createDate 2025-04-22 16:43:56
 */
public interface TUserCardRecordService extends IService<TUserCardRecord> {

    /**
     * 生成卡片记录
     *
     * @param apply 申请信息
     */
    void saveCardRecord(TUserCardApply apply);

    /**
     * 根据用户ID与卡片ID查询获取记录
     *
     * @param userId 用户ID
     * @param cardId 卡片ID
     * @return 记录列表
     */
    List<TUserCardRecord> queryCardRecord(Long userId, Long cardId);

    /**
     * 查询导出数据
     *
     * @param actiId 活动序号
     * @return 导出实体列表
     */
    List<UserCardExportRecordResDTO> listUseRecord(Long actiId);

}
